From ee9d99cba3803f926ffed1733d9bd282ade6f84e Mon Sep 17 00:00:00 2001 From: =?utf8?q?Timm=20B=C3=A4der?= Date: Wed, 20 May 2020 09:36:21 +0200 Subject: [PATCH] update documentation for new style classes and node names --- gtk/gtkassistant.c | 3 ++- gtk/gtkwindow.c | 11 ++++++++--- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c index 2e560bd339..c5da702416 100644 --- a/gtk/gtkassistant.c +++ b/gtk/gtkassistant.c @@ -58,7 +58,8 @@ * * # CSS nodes * - * GtkAssistant has a single CSS node with the name assistant. + * GtkAssistant has a single CSS node with the name window and style + * class .assistant. */ #include "config.h" diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index 0574ee4673..944a1e5d2b 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -133,13 +133,11 @@ * * |[ * window.background - * ├── decoration * ├── .titlebar [.default-decoration] * ╰── * ]| * - * GtkWindow has a main CSS node with name window and style class .background, - * and a subnode with name decoration. + * GtkWindow has a main CSS node with name window and style class .background. * * Style classes that are typically used with the main CSS node are .csd (when * client-side decorations are in use), .solid-csd (for client-side decorations @@ -149,6 +147,13 @@ * types of window often add their own discriminating style classes, such as * .popup or .tooltip. * + * Generally, some CSS properties don't make sense on the toplevel window node, + * such as margins or padding. When client-side decorations without invisible + * borders are in use (i.e. the .solid-csd style class is added to the + * main window node), the CSS border of the toplevel window is used for + * resize drags. In the .csd case, the shadow area outside of the window + * can be used to resize it. + * * GtkWindow adds the .titlebar and .default-decoration style classes to the * widget that is added as a titlebar child. */ -- 2.30.2